Sistem G2G odjemalcu ponuja določene metapodatek o storitvi. Mednje sodijo shema storitve (oblika dokumenta zahteva za izvedbo storitve), xslt transformaciji zahteve ter odgovora (prikaz obeh dokumentov v html obliki, digitalen podpis dokumentov), uporabniška navodila za storitev.
1.Klic spletne metode za pridobitev metapodatkov o storitvi
1.1. Avtorizacija z uporabniškim certifikatom
Odjemalec pokliče na spletnem servisu metodo
GetListOfServicesForG2G. Parametri:
- handle - rezultat prijave na eDavke
- language - jezik uporabniškega vmesnika odjemalca. Podrobneje.
- typeOfRequest - vrsta podatkov, do katerih želimo dostopati. Podrobneje.
- serviceId - šifra storitve, za katero želimo pridobiti podatke. Podrobneje.
Primer: zahteva za vrsto podatkov »Pogodbeni«, šifra storitve 43
string handle = Prijava();
string language = "sl";
string typeOfRequest = "Pogodbeni";
string serviceId = "43";
string response = soapService.GetListOfServicesForG2G(handle, language, typeOfRequest, serviceId);
1.2. Avtorizacija s strežniškim certifikatom
Odjemalec pokliče na spletnem servisu metodo
GetServiceG2P. V parametru
document poda XML dokument po shemi
http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_V1.xsd. Pomen parametrov:
Primer: zahteva za vrsto podatkov »Pogodbeni«, šifra storitve 43
string document = @"<ZahtevaSeznamStr>
<Glava>
<NosilecZahteveTip>PO</NosilecZahteveTip>
<NosilecZahteveZavId>37591037</NosilecZahteveZavId>
<PooblascenaOsebaZavId>37591037</PooblascenaOsebaZavId>
<Jezik>SI</Jezik>
<VrstaPodatkov>Pogodbeni</VrstaPodatkov>
</Glava>
<Postavke>
<SifraStoritve>43</SifraStoritve>
</Postavke>
</ZahtevaSeznamStr>";
string response = soapService.GetServiceG2P(document);
2. Odgovor spletnega servisa
Odgovor je dokument po shemi
http://edavki.durs.si/Documents/Schemas/G2G_SEZ_STOR_ODG_V1.xsd
Pomen polj:
- SifraStoritve – šifra izbrane storitve.
- OznakaStoritve – oznaka izbrane storitve.
- NazivStoritve – naziv izbrane storitve.
-
TipSheme – polje ima lahko dve vrednosti:
- Naslov - v polju »StoritevShema« je podan spletni naslov (url) sheme zahteve.
- Vsebina - v polju »StoritevShema« je podana vsebina sheme
- StoritevShema – shema xml dokumenta zahteve storitve. V polju je lahko podan spletni naslov do sheme, oz. vsebina sheme. Katera možnost se bo uporabila se določi pri podpisu protokola za izmenjavo podatkov.
- XsltTransformacija – naslov xslt transformacije za prikaz xml dokumenta zahteve storitve v html obliki.
- StoritevUI – definicija uporabniške maske (več v poglavju).
Primer:
<OdgovorSeznamStr>
<Glava>
<Jezik>SI</Jezik>
<VrstaPodatkov>Pogodbeni</VrstaPodatkov>
<StatusOdgovora>0</StatusOdgovora>
</Glava>
<Postavke>
<Storitev>
<SifraStoritve>43</SifraStoritve>
<OznakaStoritve>Posredovanje podatkov o dohodkih študentskim domovom/pisarnam</OznakaStoritve>
<NazivStoritve>DOH_ŠD</NazivStoritve>
<TipSheme>naslov</TipSheme>
<XsltTransformacija>DOH_SD_Z_V1.xslt</XsltTransformacija>
<StoritevShema>DOH_SD_V1.xsd</StoritevShema>
<StoritevUI>
<XmlNode xmlns="http://edavki.durs.si/Documents/Schemas/G2G_UI_STOR_V1.xsd" xmlns:g2g="http://edavki.durs.si/Documents/Schemas/G2G_V1.xsd" XmlName="Zahteva" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<XmlNode XmlName="Glava">
<Caption>
<Label Lang="SI">Podatki zahteve</Label>
</Caption>
<Input xsi:type="text" ReadOnly="true" Visible="false" XmlName="VrstaPodatkov">
<Label Lang="SI">Vrsta podatkov</Label>
<Help Lang="SI">Vrsta podatkov zahteve</Help>
<Value>Pogodbeni</Value>
</Input>
<Input xsi:type="text" ReadOnly="true" Visible="false" XmlName="SifraSistema">
<Label Lang="SI">Sifra izvornega sistema</Label>
<Help Lang="SI">Sifra izvornega sistema</Help>
<Value>EDP</Value>
</Input>
<br />
<Input xsi:type="date" ReadOnly="true" Visible="true" XmlName="DatumZahtevka">
<Label Lang="SI">Datum zahtevka</Label>
<Help Lang="SI">Datum zahtevka</Help>
<Value>2010-09-01T08:37:27</Value>
</Input>
<br />
<Input xsi:type="combobox" ReadOnly="false" Required="true" Visible="true" XmlName="VsebujePrilogo">
<Label Lang="SI">Vsebuje prilogo</Label>
<Help Lang="SI">Ali zahteva vsebuje prilogo</Help>
<Values>
<Value Key="null" NullValue="true" Selected="true">
<Label Lang="SI"><Izberite vrednost></Label>
</Value>
<Value Key="true" NullValue="false">
<Label Lang="SI">Da</Label>
</Value>
<Value Key="false" NullValue="false">
<Label Lang="SI">Ne</Label>
</Value>
</Values>
</Input>
<Input xsi:type="text" ReadOnly="true" Visible="false" XmlName="Jezik">
<Label Lang="SI">Jezik</Label>
<Help Lang="SI">Jezik uporabniškega vmesnika</Help>
<Value>SI</Value>
</Input>
<br />
</XmlNode>
<XmlNode XmlName="Postavke">
<Caption>
<Label Lang="SI">Seznam zavezancev</Label>
</Caption>
<Input xsi:type="grid" ReadOnly="false" XmlName="Postavka">
<Label Lang="SI">Davčne številke</Label>
<Help Lang="SI">Vpišite davčne številke, za katere želite pridobiti podatke</Help>
<Row>
<Columns>
<Column>
<Label Lang="SI">ZavId</Label>
<Input xsi:type="ZavId" ReadOnly="false" Required="true" Visible="true" XmlName="ZavId" />
</Column>
<Column>
<Label Lang="SI">Datum</Label>
<Input xsi:type="date" ReadOnly="false" Required="true" Visible="true" XmlName="DatumDo" />
</Column>
<Column>
<Label Lang="SI">Številka zadeve</Label>
<Input xsi:type="text" ReadOnly="false" Required="false" Visible="true" XmlName="StevilkaZadeve" />
</Column>
</Columns>
</Row>
</Input>
</XmlNode>
</XmlNode>
</StoritevUI>
</Storitev>
</Postavke>
</OdgovorSeznamStr>
Povezave
Opis osnovnih elementov shem dokumentov